home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / NEWSOFT / AUGUST / ARCWEB / ReadMeDocs / Problems < prev    next >
Text File  |  1997-07-15  |  20KB  |  429 lines
  1. Problems
  2. ========
  3.  
  4. This file is part of ArcWeb, and acts as a troubleshooting guide for those
  5. who have had difficulty installing, configuring and operating ArcWeb.  It
  6. assumes that you have read 'Instruct' and 'ReadMe1st', and if the question
  7. is about proxies, then 'WotIsProxy' as well.
  8.  
  9. Recent changes: questions and/or answers for Q24a, Q26
  10.  
  11.  
  12. Question Summary
  13. ================
  14.  
  15. Q1.  I try to run !ArcWeb I get a message saying:
  16. "Find ChangeFSI before loading".
  17.  
  18. Q2.  When I try to load !ArcWeb, it says that it requires at least
  19. version Y.YY of module XXX.   What is it and where do I get it?
  20.  
  21. Q3.  When I use the Open URL dialogue box and specify something like
  22. http://www.demon.net/ in the box, I get an error saying that there is
  23. no application loaded which can fetch that URL. What's this mean?
  24.  
  25. Q4.  When I try to use the Open URL dialogue box to open a local file using
  26. local: URLs, I get an error saying that no fetcher is available for that
  27. URL.
  28.  
  29. Q5.  When I try to use the Open URL dialogue box to open a local file using
  30. riscos: URLs, I get an error saying that no fetcher is available for that
  31. URL.
  32.  
  33. Q6.  Sometimes when I load a page, the inlined images are not displayed
  34.  
  35. Q7.  I have heard that UniSys have been threatening to enforce a patent on
  36. the LZ compression used in the GIF file format, as used by many WWW sites.
  37. Does this affect ArcWeb?
  38.  
  39. Q8. When I try to load !ArcWeb, it says 'nager: Sprites22'.  What on
  40. earth does this mean?
  41.  
  42. Q9.  [obsolete & removed]
  43.  
  44. Q10.  How do I change fonts, colours and default options if I don't like
  45. them?
  46.  
  47. Q11.  How do I set up !ArcWeb for use on a shared network
  48.  
  49. Q12.  I try to run ArcWeb and nothing happens/machine locks up/odd errors
  50. appear (eg. Permission denied).
  51.  
  52. Q13.  What does icon 'x' do?
  53.  
  54. Q14.  When I follow a link to some URLs, I get a dialogue box saying that
  55. authentication is required.  What does this mean?
  56.  
  57. Q15.  When I follow a link to some URLs, I get a dialogue box saying that a
  58. non-default port is being used.  What does this mean?
  59.  
  60. Q16.  When I try to run !ArcWeb, I get a stack backtrace/Directory Full
  61. errors
  62.  
  63. Q17.  Why do I get a save dialogue box when trying to read some pages, even
  64. when the object is HTML?
  65.  
  66. Q18.  Sometimes I get 'Too Long' (or similar) error messages whilst the page
  67. is being drawn and then none of the graphics are on the page.  Why?
  68.  
  69. Q19.  What do I do to cure 'unable to lookup host's address' errors?
  70.  
  71. Q20.  ArcWeb keeps dying with fatal internal error type=5 messages.
  72. What can I do to stop this?
  73.  
  74. Q21.  When I try to run ArcWeb, I get a message that my Filter Manager is
  75. too old and that I need version 0.09 or later.  Why?
  76.  
  77. Q21a. Why doesn't ArcWeb attempt to load the more recent Filter Manager that
  78. I've got in my !System.
  79.  
  80. Q22.  Why does ArcWeb take up so much memory?
  81.  
  82. Q23.  Email and ftp work fine on my machine, but ArcWeb has trouble
  83.       downloading anything at a reasonable speed: why?
  84.  
  85. Q24.  How do I enable the font blending options?
  86.  
  87. Q24a. When I've enabled Font Blending, all the text everywhere seems to come
  88.       out completely black and unreadable.
  89.  
  90. Q25.  When I try to run ArcWeb it tells me that "The cache has been locked by
  91. a browser running on another machine".  Should I click Cancel or should I
  92. override the lock?
  93.  
  94.  
  95. Questions & Answers
  96. ===================
  97.  
  98. Q1.  I try to run !ArcWeb or !ArcWebImg and I get a message saying:
  99. "Find ChangeFSI before loading".
  100.  
  101. A1.  ArcWebImg uses ChangeFSI as its image manipulator.  It invokes it on the
  102. command line to transform GIFs, JPEGs and other formats into RISC OS sprite
  103. files.  If the Filer has not seen ChangeFSI, then ArcWebImg does not know
  104. where it will be able to find this tool.  Open a directory viewer containing
  105. !ChangeFSI and then try to run ArcWebImg again.  If ArcWebImg was auto run
  106. by ArcWeb, then you will have to quit ArcWeb and load it again, or open the
  107. !WebHelper application (double-click it - no SHIFT required) and run !ArcwebImg
  108. directly.
  109.  
  110.  
  111. Q2.  When I try to load !ArcWeb, it says that it requires at least
  112. version Y.YY of module XXX.   What is it and where do I get it?
  113.  
  114. A2. All the necessary modules are provided in the !System supplied with this
  115. version of ArcWeb (ie. in the separate toolbox.arc archive). You should merge
  116. the !System directory with your master copy.  RISC OS 3.1 users should run
  117. !SysMerge to do this. For RISC OS 3.5 and later, double-click on your !Boot
  118. directory and click on the System icon and drop the new !System directory
  119. into the new window, although some people have reported that this doesn't
  120. work properly, but that using !SysMerge does.
  121.  
  122.  
  123.  
  124. Q3.  When I use the Open URL dialogue box and specify something like
  125. http://www.demon.co.uk/ in the box, I get an error saying that there is
  126. no application loaded which can fetch that URL. What's this mean?
  127.  
  128. A3.  ArcWeb has rejected the URL as one it cannot handle itself, and it
  129. has failed to find another application willing to deal with it.  If you
  130. need a specialise application loaded and it isn't already loaded, you
  131. should load it and retry the URL.  Otherwise, look in the Network options
  132. (from the icon bar Configure submenu) and check that the appropriate
  133. protocol box at the top of the window is checked.  You cannot check WAIS
  134. because this is not supported by ArcWeb.
  135.  
  136.  
  137. Q4.  When I try to use the Open URL dialogue box to open a local file using
  138. local: URLs, I get an error saying that no fetcher is available for that
  139. URL.
  140.  
  141. A4.  This shouldn't happen since local: URLs are handled by Arcweb
  142. internally. However, this may indicate  some failure occurred finding the
  143. file.  This may be because:
  144.  
  145.   i) the filing system you used does not exist
  146.  ii) the URL specified a non-existent file
  147. iii) you did not specify the URL correctly.  Remember that all / and .
  148.      characters after the :: in the filing system name, are transposed.
  149.  
  150. Remember that these URLs will look odd.  Examples of valid URLs:
  151. local://ADFS::HardDisc4/$/WWW/index.html  (ADFS::HardDisc4.$.WWW.index/html)
  152. local://SCSI::ScsiDisc7/$/Internet/me.gif (SCSI::ScsiDisc7.$.Internet.me/gif)
  153. local://resources:/$/Apps/!Help           (resources:$.Apps.!Help)
  154.  
  155. Note in particular the strange format for local URLs on filing systems which
  156. do not use device names (eg. resources:)
  157.  
  158.  
  159. Q5.  When I try to use the Open URL dialogue box to open a local file using
  160. riscos: URLs, I get an error saying that no fetcher is available for that
  161. URL.
  162.  
  163. A5.  riscos: URLs were handled by earlier versions of ArcWebLcl.  This URL
  164. naming scheme is now obsolete, superceded by local: URLs, which you must now
  165. use.  NOTE: Running on old version of ArcwebLcl alongside the new ArcWebLcl
  166. will not work, as support for the riscos: name system in ArcWeb itself has
  167. been removed.  This is because separate routines were needed for resolving
  168. relative references involving riscos: URLs, and these no longer exist.
  169.  
  170.  
  171. Q6.  Sometimes when I load a page, the inlined images are not displayed
  172.  
  173. A6.  Look at the page's menu under the Options submenu to make sure that you
  174. haven't disabled the loading of inlined images.  Alternatively, there may not
  175. have been enough memory available to perform a conversion from the original
  176. graphics format to sprite format.  There is another problem caused whenever
  177. early versions of ImageFS are loaded and intercepting GIF and JPEG formats. 
  178. You should disable such versions of ImageFS whilst using ArcWeb for the
  179. moment. The latest ImageFS should be fine though.
  180.  
  181.  
  182. Q7.  I have heard that UniSys have been threatening to enforce a patent on
  183. the LZ compression used in the GIF file format, as used by many WWW sites.
  184. Does this affect ArcWeb?
  185.  
  186. A7.  No.  ArcWeb does not contain any code for handling GIF format graphics
  187. files.  It merely tests files for filetype &695 (GIF) or for starting GIF87a
  188. or GIF89a, and pulls out the image pixel size (for imagemaps).  [GIF is a
  189. registered trademark (and service mark) of CompuServe Inc.]
  190.  
  191.  
  192. Q8. When I try to load !ArcWeb, it says 'nager:Sprites22'.  What on
  193. earth does this mean?
  194.  
  195. A8. This is a fault in RISC OS 3.50.  An error has occurred whilst trying
  196. to run the !ArcWeb.!Run file but due to the OS fault, the error message
  197. has been overwritten with the end of the string "WindowManager:Sprites22".
  198. The error could be any number of things, from a failure to locate a module
  199. in the RMEnsure statements; failing to set ArcWeb$CacheDir; failure to
  200. allocate enough memory.  You need to check the following common causes:
  201.  
  202. * Not having FilterManager 0.09 or later (see Q21 for details)
  203.  
  204. * Failing to load a sufficiently up-to-date version of the DrawFile module.
  205.  
  206.  
  207.  
  208. Q10.  How do I change fonts, colours and default options if I don't like
  209. them?
  210.  
  211. A10.  There are two levels at which the changes can be made - system wide,
  212. or user specific.  ArcWeb checks the following files for font definitions
  213. and colour schemes in this order: 1)  <WebCache$Dir>.Choices 
  214. 2) <ArcWeb$Dir>.Defaults   3) built-in defaults (you can't change these).
  215.  
  216. All the configuration windows are linked from the the Options menu on the
  217. web pages or on the Configuration submenu of the icon bar menu.  You can
  218. alter the settings and then make them permanent by using "Save Options".
  219.  
  220.  
  221. Q11.  How do I set up !ArcWeb for use on a shared network
  222.  
  223. In order to stop proliferation of ArcWeb into everyone's home directories,
  224. ArcWeb is willing to cooperate in a network environment.  !ArcWeb may be
  225. installed in a read-only filing system. Users will also need to have seen a
  226. !WebCache application to which they have exclusive use and to which they have
  227. read-write access.  Only one instance of ArcWeb may use any !WebCache
  228. directory.
  229.  
  230. If you are connected to the Internet via a UNIX gateway, then I strongly
  231. recommend running some form of proxy HTTP server on it.
  232.  
  233. The system administrator may wish to edit !ArcWeb.!Run to refuse to run if
  234. Arcweb$CacheDir is not set (as supplied, if it isn't set, it sets it to a
  235. subdirectory of itself).  The system administrator may choose to edit the
  236. !ArcWeb.Defaults file to change any system wide options.
  237.  
  238.  
  239.  
  240. Q12.  I try to run ArcWeb and nothing happens/machine locks up/odd errors
  241. appear (eg. Permission denied).
  242.  
  243. A12.  This might be caused by !WebCache not being installed in a read/write
  244. filing system.  Unless you have appropriate archiving software (eg. SparkFS
  245. or ArcFS 2), you will have to extract the !WebCache application to a
  246. writable filing system, and then double-click on the WebCache icon to
  247. install it.
  248.  
  249. Q13.  What does icon 'x' do?
  250.  
  251. A13.  ArcWeb supports interactive help.  Load the Acorn !Help application and
  252. you will be given help about the buttons under the pointer when in an ArcWeb
  253. window.  Note that in the window displaying the page itself, the help is
  254. purely the URL which would be opened if you were to click SELECT.
  255.  
  256. Q14.  When I follow a link to some URLs, I get a dialogue box saying that
  257. authentication is required.  What does this mean?
  258.  
  259. A14.  To allow information providers to restrict access to certain web
  260. pages, there is an authentication capability in the HTTP protocol.  The
  261. authentication domain is a combination of the host name and a 'realm' (just
  262. a keyword indicating which user/password is required).  If you do not have
  263. a valid user name and password, then you will not be able to access the URL.
  264. If you do, then enter them in the boxes and press RETURN (or click OK).  If
  265. you toggle the authetication window to full size, you will see which server
  266. is asking for authentication and in which domain.  NOTE:  Authentication
  267. checking is performed at the *server* not the client, so you can't get
  268. around it by hacking at ArcWeb.  ArcWeb will cache the user/password
  269. together with the server and realm and attempt to auto-authenticate you in
  270. future connections to that server.  This cache is destroyed when ArcWeb
  271. exits (although you can override this behaviour).
  272.  
  273. Q15.  When I follow a link to some URLs, I get a dialogue box saying that a
  274. non-default port is being used.  What does this mean?
  275.  
  276. Most Internet based protocols such as FTP, HTTP, Finger, SMTP, NNTP etc. are
  277. defined as existing at a particular 'port' on a server which supports the
  278. protocol.  eg. HTTP is usually at port 80, FTP is at port 21.  Sending
  279. control messages of one protocol to a different server port may cause damage
  280. at the local machine (your machine!) or at the server, or it may connect you
  281. to undesirable (and sometimes illegal - although this is very uncommon)
  282. services.  To help you recognise these rogue URLs, you will be asked for
  283. confirmation when ArcWeb finds that the default port has been overridden
  284. (except for HTTP, as it is commonly run on port 8001, 8080 as well as 80). 
  285. It's not by any means a foregone conclusion that any non-standard port
  286. connection is dangerous or illegal, but this way you at least have the option
  287. of blocking the connection.
  288.  
  289.  
  290. Q16.  When I try to run !ArcWeb, I get a stack backtrace/Directory Full
  291. errors
  292.  
  293. A16.  You must remove your old !WebCache directory before installing the
  294. new !WebCache because the directory hierarchy underneath the !WebCache.Data
  295. directory has changed in order to allow you over a 1000 entries in the cache
  296. instead of limiting it to 75.  If this isn't the problem, then email me the
  297. stack backtrace.  (Tech: you can capture the stack backtrace to a file by
  298. adding " 2>stacktrace " to the end of the last line of !ArcWeb.!Run.  The
  299. stack backtrace will then appear in a file called stacktrace in the current
  300. directory.)
  301.  
  302.  
  303. Q17.  Why do I get a save dialogue box when trying to read some pages, even
  304. when the object is HTML?
  305.  
  306. A17.  If the server did not send, or the fetcher failed to parse, the special
  307. Content-Type header returned by the server (this won't happen with KA9Q), then
  308. ArcWeb does not know what to do with the object.  From version 0.25, there is
  309. an option on the Options menu to attempt to 'execute' unknown objects.  There
  310. is also a fix for an incorrect parse of Content-Type headers in A/TCP 0.21
  311.  
  312.  
  313. Q18.  Sometimes I get 'Too Long' (or similar) error messages whilst the page
  314. is being drawn and then none of the graphics are on the page.  Why?
  315.  
  316. A18.  ArcWeb uses external programs to convert GIF and JPEG files into
  317. RISC OS sprites.  To do this, it constructs a command line which invokes
  318. the translator and tells it the input and output files.  When RISC OS runs
  319. the command string through its routines, it is possible for an overflow to
  320. occur (ie. the command ends up longer than the maximum permitted command
  321. length).  This is when the OS generates the Too Long error.  To fix it, you
  322. need to move the relevant programs closer to your root directory. 
  323. Specifically, !WebCache and !ChangeFSI are the programs that are
  324. concerned.  Using ..$Path variables does not seem to help, as the OS is
  325. canonicalising the paths.
  326.  
  327.  
  328. Q19.  What do I do to cure 'unable to lookup host's address' errors?
  329.  
  330. A19.  First of all, check you've spelt the hostname correctly in the URL.
  331. Check the DNS configuration.  Open the DNS tester by choosing it
  332. from the Show menu on the icon bar menu.  If all three of the DNS boxes
  333. at the top read 'None', then it indicates that the resconf file was not
  334. found.  Check that InetDBase$Path points to a directory containing a
  335. resconf and hosts files.  If it doesn't you need to do:
  336. *Set InetDBase$path The.full.pathname.to.!Internet.files.
  337. (including the final .)   If the DNS resolvers are known, then click on
  338. the Lookup Name icon next to the top one.  The Answer box should come
  339. back with the official name of the machine.  If it fails, then it means
  340. that all the DNS servers in your list are not working (or that your
  341. computer cannot find a way to reach them because you aren't connected
  342. or something).
  343.  
  344.  
  345. Q20.  ArcWeb keeps dying with fatal internal error type=5 messages.
  346. What can I do to stop this?
  347.  
  348. A20.  This means that something has gone wrong internally for some
  349. reason.  Although the problem might not be caused by ArcWeb, something which
  350. it interacts with has caused some condition which was unexpected.  The
  351. best way to deal with this is to follow the instructions on sending
  352. bug reports by following the link from the default home page.
  353.  
  354.  
  355. Q21.  When I try to run ArcWeb, I get a message that my Filter Manager is
  356. too old and that I need version 0.09 or later
  357.  
  358. Q21a. Why doesn't ArcWeb attempt to load the more recent Filter Manager that
  359. I've got in my !System.
  360.  
  361. A21/A21a.  ArcWeb requires FilterManager 0.09 or later to be installed on
  362. your machine.  It may be the case that you have this module in your System
  363. directory but have an earlier version in ROM.  ArcWeb will NOT kill the
  364. earlier Filter Manager module if it is active, because some tasks which don't
  365. behave properly fail to cope with the Filter Manager dying and the whole
  366. desktop dies task by task.  The cure for this is to ensure that FilterMgr is
  367. loaded BEFORE entering the Wimp on boot up by loading it during your boot
  368. sequence.  For Risc PC owners, this will be in the Misc section of
  369. !Boot.Choices.Boot.PreDesktop.  For other machines, it will depend on your
  370. setup.
  371.  
  372.  
  373. Q22.  Why does ArcWeb take up so much memory?
  374.  
  375. A22.  Simply because it contains so much code.  ArcWeb attempts to cater for
  376. all kinds of rubbish being downloaded (either maliciously or accidentally).
  377. Some things which are required are not available as part of the OS, so have
  378. to be implemented by me instead (eg. multiline text icons in the cookie
  379. and meta-info dialogue boxes).  Some code is included as a work around for
  380. bugs in the OS (libjpeg).  Code for handling most foreign graphics formats is
  381. ported from other platforms where code size is not considered important.  Such
  382. code is too complicated for me to develop myself so there's no chance of me
  383. writing an optimised version I'm afraid.
  384.  
  385.  
  386. Q23.  Email and ftp work fine on my machine, but ArcWeb has trouble
  387.       downloading anything at a reasonable speed: why?
  388.  
  389. A23.   Sometimes the Internet just gets overloaded, however, Web browsing
  390. puts a heavy load on your computer compared with things like ftp --
  391. especially if you are using a modem -- and your poor machine just can't keep
  392. up with all the data being thrown at it.  If you are running lots of nice
  393. desktop enhancements, these can use more processor time than you might
  394. imagine.  Try not using any more software than is necessary when running
  395. ArcWeb, and use smaller screen modes with fewer pixels and colours to consume
  396. less bandwidth on older machines.  [Thanks to Chris Latham]
  397.  
  398.  
  399. Q24.  How do I enable the font blending options?
  400.  
  401. A24.  First of all, you must have RISC OS 3.7 or later.  If you don't, then
  402. this facility (provided by the Font Manager) is not available - sorry.  If
  403. you do, then just enable the option in the Browser configuration window
  404.  
  405.  
  406. Q24a. When I've enabled Font Blending, all the text everywhere seems to come
  407.       out completely black and unreadable.
  408.  
  409. A24a. Make sure you haven't set the InverseTable dynamic area to be virtual
  410.       in the Virtualise configuration window. [Thanks to Andreas Feldner]
  411.  
  412.  
  413. Q25.  When I try to run ArcWeb it tells me that "The cache has been locked by
  414. a browser running on another machine".  Should I click Cancel or should I
  415. override the lock?
  416.  
  417. A25.  This message may appear if your machine crashed whilst ArcWeb was
  418. running.  If this was the case, then you should override the lock.  If you
  419. are using a shared directory for the cache, then it is possible that another
  420. machine is already using the !WebCache directory.  If two running versions of
  421. ArcWeb attempt to share the same cache, it's asking for trouble (Choices,
  422. bookmarks and cache contents can become corrupt).  If the machine named is
  423. not running ArcWeb, then you can safely override the lock.
  424.  
  425.  
  426. --
  427. Stewart Brodie
  428. 3rd June 1997
  429.